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This VM/SP guide describes some 
essential VM/SP operations for the 
nevv user, İt also provides a 

brief description of all VM/SP 
commands for the experienced user. 
Only a limited amount of prior 
VM/SP knowledge is required for 
the section on VM/SP operations. 
Prerequisite publications are listed 
in the “Preface,” 


The user of the VM/SP command 
descriptions (for CP, CMS, RSCS, 
and IPCS) and service aids section 
should have a thorough understanding 
of VM/SP command syntax and usage. 


This publication is part of a set of 


reference summaries that are obtainable 
as a group under Order No. SBOF3820 


xo. 4 
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otice: The term VM/SP, as used in this| 
lication, refers to VM/SP when used in| 
junction with VM/370 Release 6. l 
(u 57 


First Edition (September 1980) 


This edition, SX20-4400, applies to the IBM 
Virtual/System Product, and to all 
subsequent releases unless otherwise 
indicated in new editions or Technical 
Newsletters. 


Changes are periodically made to the 
information herein; before using this 
publication in connection with the 
operation of IBM systems, consult the 
latest IBM System/370 and 4300 Processors 
Bibliography, Order No.  GC20-0111, for the 
editions that are applicable and current. 


It is possible that this material may 
contain reference to, and information 


about, IBM products (machines and 
programs), programming, or services that 
are not announced in your country. Such 
references or information must not be 


construed to mean that IBM intends to 
announce such IBM products, programming, or 
services in your country. 


Publications are not stocked at the address 
given below; requests for copies of IBM 
publications should be made to your IBM 
representative or to the IBM branch office 
serving your locality. 


A form for readers' comments is provided at 
the back of this publication. If the form 
has been removed, address comments to IBM 
Programming Publications, Dept. G60, P. O. 
Box 6, Endicott, New York U.S.A. 13760. 
IBM may use or distribute any of the 


information you supply in any way it 
believes appropriate without incurring any 
obligation whatever. You may, of course, 


continue to use the information you supply. 


© Copyright International Business 
Machines Corporation 1980 


This publication provides a quick reference 
to VM/SP for both new and more experienced 
users. 


The section "Using VM/SP" describes how 
to access the VM/SP system and control 
terminal operations, how to create files 
and manipulate data, and how to code and 
debug programs using CMS. 


The section "Summary of VM/SP Commands" 
is an alphameric listing of all the VM/SP 


commands and service aids. For each 
command, a brief description of its 
function is included, as well as the 
complete command format. The section also 


describes the syntax conventions used in 
the command formats and summarizes the CP 
privilege classes. 


BINDER AVAILABLE 


A handbook-sized binder, FE part number 
s229-4124, may be purchased from IBM. 
Customers may order it through their IBM 


marketing representative. IBM personnel 
Should order it as an FE part from 
Mechanicsburg. 


Preface iii 


"RR w kk a cw Q S Ga kai | U ` 


This publication includes commands and 
operands that pertain to the VM/SP System 
Control Program (5664-67). 


The new user should use the following 


VM/SP publications in conjunction with the 
first sections of this publication: 


PREREQUISITE PUBLICATIONS 


ntroduction, GC19-6200 


IBM Virtual Machine/System Product: 


System Messages and Codes, SC19-6204 


Terminal User's Guide, GC19-6206 


System Product Editor Command and Macro 


Reference, SC24-5221 


EXEC 2 Reference, SC24-5219 
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Experienced users should be familiar with 
the contents of the following publications: 


Planning and System Generation Guide, 


Operator's Guide, SC19-6202 


Preface v 


vi 


IBM VM/370 Quick Guide for Users 


CONTE 


USING THE VM/SP SYSTEM . . . . . < < < e 
Getting GEES a < e ^ s < e wo 
Terminal Operating Procedures. . . . .. 
Logging DIF u- 4 e a “< e Re l e €* m 
Logging Ge uu". < = € a e E a ə 
Input Conventions. .. . < e . ` ə = ə ə 
Attention Handling «^. < e s e < < = ə 


USING EMS. <a a dd ces o. m * 
How To IPL CES: Sw Reie e < erg a e Q lw 
CMS System Product Editor. . . e < < « 
EXEC 2 Interpreter . . . ə . 
System Product Editor (KEDIT) and EKEC 
2 Combined Features Q . we $ e < <= o 
Example of CMS Program Development 
FADOilitibs. Zu AW HR V ox au wo * a 
Creating an Assembler Language Source 
Files > v oca ca . Se a e w e 
Assembling a Source File . . . . oo. 
Creating a Load Module . . . < +s < <= < 
Erasing Unwanted Files . . . ə 
Printing, Punching, and Reading Files. 


Reserved Filetype Descriptions . . . . + 
Return COQGS x a”əy, ə e e * 5 Se £ 0 
CMS Return Codes . . . w we dol a) e. 
CP DIRECT Command Return Codes « ae ə 
CMS DDR Command Return Codes . . . " 
System Product Editor (XEDIT) Command 
Retard, COĞƏSL İR 4 < e » ə Q < «<=. o» 
IPCS Commands Return Codes . . a . . . 
Example of a Return Code from a CP 
CORNMUSUĞR A ¿Taj $ € Q Ree » x » * 


SUMMARY OF VM/SP COMMANDS AND SERVICE 
ATDS. 4 ws id 079 0 “< ew e fe ow wow A 
Notational Conventions . .. . . . = . 
CP Privilege Classes . . Ka a 3 
CP, CMS, RSCS, and IPCS Commands e * s 


Contents 


NTS 


vii 


FIGURES 


Figure 
Figure 


Figure 


Figure 


Figure 
Figure 
Figure 
Figure 


Figure 


Figure 
Figure 


Figure 


viii 


11. 


12. 


| ` 


Attention Handling in VM Mode 
(2 Pacts) cece ce cee sa su ow 
Attention Handling in 

CP Mode... nen m . 10 
Summary of Screen Status 
Action while Executing CMS 

and CB.[2 Parts) somwa 12 
Sample Assembler Language 
Program Used for Creating a 
Source File (2 Parts)....... 18 
Reserved Filetypes 

[8 YOLU A A E e aa ıı? 
Return Codes Produced by 

CMS 13 PAS esa rr dəəə İT 
Return Codes Produced by the 
CP DİRECT Commanders cas acces ou 40 
Return Codes Produced by 

the CMS DDR Command......... 40 
Return Codes Produced by 

the System Product Editor 
(XEDIT )Command (2 Parts)...42 
Return Codes Produced by the 
IPCS Conmands.........-.--..ü3 
Syntax Abbreviations 

ÜGƏR AAA İb 
CP Privilege Class 
Descriptions (3 Parts)......47 


IBM VM/SP Quick Guide for Users 


IBM Virtual Machine/System Product (VM/SP) 
is a system control program that controls 
virtual machines. A virtual machine isa 
functional simulation of a real processor 
and its 1/0 devices. VM/SP builds and 


i maintains, for each user, a virtual 
| System/370 machine from a predefined 
| configuration. 

The virtual machine configuration 


includes components corresponding to a real 
System/370: a virtual operator's console, 
virtual storage, a virtual processor, and 
virtual channels and I/O devices. However, 
since the virtual machines are simulated, 
their configurations may differ from that 
of the real machine and from each other. 
| For example, the real machine may have 512K 
| bytes of real storage and eight real disk 
drives, while a virtual machine may have 
768K bytes of virtual storage and two 
virtual disk drives. 


GETTING STARTED 


Before you can start using VM/SP, you must 


have: 
e A user identification and password. 
Your user identification (userid) 


identifies you to VM/SP. Your password 
is checked when you log on, and protects 
your virtual machine from unauthorized 
use. The VM/SP system operations group 
usually assigns userids and passwords. 
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e A virtual machine defined for your use. 
The virtual machine definition should 
include all the devices you expect to 
use -- for example, a console, card 
reader, card punch, printer, and disk 
space. The VM/SP system operations 
group usually defines your virtual 
machine configuration. 


e Properly formatted disk space. The 
VM/SP system operations group usually 
formats disk space, but you can format 
your own disk space using the FORMAT 
command. See VM/SP CMS User's Guide for 
details on formatting your disk space. 


Once you have your userid and password, 
you can communicate with the VM/SP system 
from a terminal such as an IBM 2741 
Communications Terminal, IBM 1050 Data 
Communication System (or equivalent), or 
3277 display terminal. Depending on your 
terminal, you either dial the central VM/SP 
computer, or are connected to it directly. 
For a description of the communication 
procedures for each type of terminal, see 
the VM/SP Terminal User's Guide. 


TERMINAL OPERATING PROCEDURES 


— — — i — M —— —— — — ——.— € ———— — o e M — 


For a more detailed description of the 
various terminal operating procedures, see 
the VM/SP Terminal User's Guide. 


LOGGING ON 


First, establish communication with VM/SP 
by turning on your terminal's power. The 
System sends a VM/370 ONLINE message or 
logo to the terminal. 
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Press the attention (ATTN) key, PA1 key 
(or equivalent), type logon, and identify 
yourself by entering your user 
identification (pubs, in this example) as 
follows: 


logon pubs 


Then press the Return key, the carriage 
return, the Enter key, or your terminal's 
equivalent. 


The VM/SP system responds with: 
ENTER PASSWORD: 


At this point, you Should enter your 
password, and then press the Return key or 
its equivalent. 


Note: For security purposes, many terminals 
supported by VM/SP provide a masking 
technique to prevent display or printing of 
the password when you enter it. For more 
information on using the Print Inhibit 
feature, see the VM/SP Terminal User's 
Guide. 


If the password you enter is incorrect, 
the message, 


DMKLOGO50E PASSWORD INCORRECT 
is sent to the terminal. You must start 
the logon procedure from the beginning by 
entering your userid again. If you do not 
do this, you are prompted by the message: 

RESTART 

If the userid and password you enter are 
valid, but someone else has already logged 
on with this userid, the VM/SP system 
issues the message: 


DMKLOGO54E ALREADY LOGGED ON LINE nnn 


Using the VM/SP System 3 


where nnn indicates the real line address 
of the terminal on which the user is 
logged. If you want to find out why the 
userid you just entered is in use, issue 
the MSG command to send a message to the 
operator or to the other user. You should 
either log on with another userid (if 
another userid is reserved for your use) or 
try again later. 


Once you have successfully logged on, 
the VM/SP system replies with a LOGON AT 
message, such as: 


LOGON AT 11:24:35 EST THURSDAY mm/dd/yy 


A logon message from the VM/SP operator (if 
any) also displays at this time. 


Once you have successfully logged on the 
VM/SP system, you can start using the 
virtual machine that you have set up for 
your userid. 


LOGGING OFF 


When you are finished using the system and 
want to end your terminal session, you do 
so by logging off of the VM/SP control 
program (CP). Even if you are in CMS mode, 
you need only enter the command: 


logoff 


and press the Return key (Or its 
equivalent). The system responds with: 


CONNECT- 00:11:43 VIRTCPU= 000:05.21 
TOTCPU= 000:21.03 
LOGOFF AT 11:34:44 EST THURSDAY mm/dd/yy 


and the connection with the VM/SP system 


terminates. The connect time is in hours, 
minutes, and seconds. The system displays 
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the use of the virtual processor and total 
processor in minutes, seconds, and 
hundredths of a second. Only when the 
logoff procedure is completed should you 
turn off terminal power. 


Note: If you logged on over a dialed line, 
you could specify that the communication 
line be left connected so that another user 
can logon immediately from the sane 
terminal. When you issue 


logoff hold 


the next user does not have to re-dial the 
line before logging on again. 


INPUT CONVENTIONS 


Input data in either uppercase Or 
lowercase. The examples in this book show 
the lines you might enter in lowercase. 
System responses appear in uppercase. 


VM/SP assigns logical line editing 
functions to four special Characters. 
These characters allow you to easily 
correct errors while you enter lines. 


The logical line edit characters shown 
below are line edit default values. Your 
installation or your terminal may require 
other characters to fulfill the line edit 
functions. 


Character Delete symbol (3): The character 
delete symbol deletes the preceding 
character in the input line. A string of 
"n" character delete symbols deletes the 
preceding "n" characters in the input line 


and itself. For example: 


ABC@@® results in A 
ABC#Dddd results in AB 
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Line End symbol (#): The line end symbol 
indicates the end of a logical input line. 
Use of this character permits you to enter 
more than one logical input line in the 
Same real input string. You can use this 
symbol to type several commands on the same 
line. CMS stacks the commands and executes 


them in sequence. For example: 
down 1#typetl#top 
executes the commands as though entered: 


down 1 
type 1 
top 


Line Delete symbol (¢): The line delete 
symbol deletes all characters in the 
current logical line and itself. If you 
enter a line delete symbol erroneously, you 
can cancel its effect by entering a 


character delete symbol. For example: 


ABC#DEF¢ results in ABC 
ABC#¢ results in ABC 
ABC£ deletes the whole line 


Logical Escape symbol ("): The logical 
escape symbol causes VM/SP to interpret the 
character following it as a data character 
(that is, to ignore it as a logical line 
editing character). This allows the system 
to interpret any of the line editing 
characters literally. For example, 
consider how you might enter the following 
line into the system: 


1 gross #2 pencils à 92¢ per dozen 
Under the VM/SP input conventions, you 
could not enter this line as shown, since 


it would be affected by the #, 0, and £ 
line editing symbols. For example, the # 
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symbol would end the line. However, VM/SP 
interprets the line correctly if entered as 
follows: 


1 gross "#2 pencils "@ 92"¢ per dozen 


The logical escape characters (") are not 
put in the file. 


Line Length: For all VM/SP commands, input 
line length is restricted by the physical 
limitations of the terminal device, or by 
the default record length. Lines exceeding 
the maximum number of characters (including 
blanks, backspaces, underscores, the line 
editing characters, and the tab character) 
are truncated to that line length value. 


Line Termination: An input data line from 
an IBM 2741 Communications Terminal is 
transmitted to the computer by pressing the 
return key. The same function is performed 
on the 3277 display terminal by pressing 
the enter key. Other terminals have 


Similar line termination keys. 


ATTENTION HANDLING 


Figures 1 and 2 indicate the various 
effects of an attention interruption for 
your virtual console. Figure 3 shows the 
screen control functions of the Enter and 
Cancel keys for display terminals. 
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USING CMS 


Before you can use CMS, you must do the 
following: 


e Log on with a valid user identification 
and password. The user identification 
Should have a virtual machine defined 
for its use. 


e Initial program load (IPL) the CMS 
system by specifying the name of the CMS 
System or the device address of the CMS 
system disk. 


e Have disk Space available that is 
formatted for use by CMS. 


The logging on procedure is discussed in 
the "Terminal Operating Procedures" section 
of this book. The IPL procedure is 
described in this section. Disk formatting 
is detailed in VM/SP CMS User's Guide. 


HOW TO IPL CMS 
After you have logged on the VM/SP system, 
you can load (IPL) an operating system. 
Assume that CMS is the systemname of 
your CMS operating system and that 190 is 
the CMS system disk. You can load this CMS 
system with either of the following 
commands: 
ipl cms 


ipl 190 
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If you have properly formatted disk space 
available you can now use the facilities of 
CMS. 


CMS SYSTEM PRODUCT EDITOR 


The system product editor XEDIT, which 
coexists with the current CMS editor, 
provides for full screen usage. Its 
enhancements include: 


e Multiple views of the same file 
e Multiple files viewed on the same screen 
e Selective column viewing 


e Automatic wraparound of lines that are 
longer than the screen 


e Ability to issue selected commands 
directly from the displayed line 


e Ability to define screen formats as 
preferred 


For a thorough understanding of the 
System product editor (XEDIT) and its 
diverse uses, see VM/SP System Product 
Editor User's Guide and  VM/SP System 


Product Editor Command and Macro Reference. 


EXEC 2 INTERPRETER 


Coexisting with the EXEC processor 
currently in use, the EXEC 2 interpreter 
features: 


e Acceptance of 255-character words 


Using CMS 15 


0000000 ..oN 


ə Issuance of commands to either CMS or to 
specified other subcommand environments 


e String manipulation functions 


e Arithmetic functions for multiplication 
and division 


e Debugging facilities 


e Support for user-defined functions and 
subroutines 


For a thorough understanding of the 


system product EXEC 2 interpreter, see 
VM/SP EXEC 2 Reference. 


SYSTEM PRODUCT EDITOR (XEDIT) AND EXEC 2 
COMBINED FEATURES 


Combined use of the system product editor 
(XEDIT) and EXEC 2 provides for expansion 
and flexibility in language with the 
following: 


e Extended string search to facilitate 
text processing 


e Automatic update generation functions 

e Packed file handling functions 

e CMS HELP Facility support 

e Column pointer for intraline editing 

e Line splitting and/or joining functions 
e Import and/or export of data facilities 


e Macros for use in migrating from EDIT or 
DES (display editing system) 
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OF CMS PROGRAM DEVELOPMENT 


This section illustrates several CMS 
functions that are useful in creating and 
manipulating CMS files. 


CREATING AN ASSEMBLER LANGUAGE SOURCE FILE 


The program shown in Figure 4 in this 
section is an Assembler Language program 
that reads data from one CMS file and 
writes it to another CMS file. After you 
have logged on the system and issued IPL 
CMS, you can create the program using the 
CMS EDIT facility. 
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unc ss 


The Editor (the term applied to the edit 
program that is used by the EDIT command), 
did not find a file with the filename and | 
filetype of MANIP ASSEMBLE, so it created | 
the file for you. Enter the INPUT | 
subcommand so that you can enter your | 
program code into the file. You must issue 
the FILE subcommand in order to save your | 
progran. 


This program (MANIP CSECT) uses several 
CMS macros; when it is assembled, this | 
program requires the CMS macro library. To | 
identify the macro libraries to be searched | 
issue: | 


global maclib cmslib osmacro | 
The Load Address (LA) instruction following 
EOF (end-of-file) is inserted only for 


testing; it is deleted after the function | 
is tested. 


ASSEMBLING A SOURCE FILE 


To assemble the MANIP program, you enter 
the "ASSEMBLE MANIP" command, then wait for 
the assembler to complete processing. The 
assembler expects to find a CMS file with 
the filetype ASSEMBLE. 


assemble manip 
Hk KK 


ASSEMBLER (XF) DONE 
MAN00331 B ERRT 
IEUO24 NEAR OPERAND COLUMN 1-UNDEF SYMBOL 


1 STATEMENT FLAGGED IN THIS ASSEMBLY 
8 WAS HIGHEST SEVERITY CODE 
R (00008) ; 
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Each asterisk (*) on the second line 
indicates two seconds of virtual processor 
time. The message IEUO24 indicates an 
error in your program. The line in your 
program containing the error has a sequence 
number of MAN00331. Display or print your 
listing file to find this line. 


At this point, three files are 
associated with your program. 


First, the MANIP ASSEMBLE file contains 
the source statements of your program. 
This file vas the input used by the 
Assembler Language program. The output 
from the assembler is two permanent files, 
MANIP TEXT and MANIP LISTING. 


The MANIP TEXT file contains the object 
module. 


The MANIP LISTING file contains a 
listing of the source statements, assembled 
machine code, and other associated 
information based on the options selected 
for the ASSEMBLE command. 


Since the assembler has detected an error 
in the source code, you must correct the 
error before attempting tc execute the 
program. Just as you used the editor to 
create the assembler file, ycu also use the 
editor (either the CMS Editor or the System 
Product Editor (XEDIT)) to change or 
correct the assembler file. When you issue 
the EDIT MANIP ASSEMBLE command this time, 
the editor finds your file and enters edit 
mode. Then issue the LOCATE subcommand to 
find the line in error. Issue the CHANGE 
subcommand to correct the error and then 
issue FILE to save the corrected program. 
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The terminal output is as follows: 


edit manip assemble 


BDIT:! 

locate /errt/ 

B ERRT 

Change /errt/erret/ 
B ERRET 

file 

R; 


Now that the error has been corrected, 
you can assemble the file again: 


assemble manip 
****+*i 


ASSEMBLER (F) DONE 


NO STATEMENTS FLAGGED IN THIS ASSEMBLY 
R; 


This time, the program assembled without 
any assembler-detected errors. The TEXT 
and LISTING files from the previous 
assembly are erased automatically and 
replaced by the new ones from the current 
assembly. 


CREATING A LOAD MODULE 


You can now create a load module from the 
TEXT file that was created by the 
assembler. The resulting MODULE file can 
then be executed. 


load manip 
R; 


genmod manip 
R; 


22 IBM VM/SP Quick Guide for Users 


Now, a fourth tee, MANIP MODULE, 
exists. This file is in executable forn. 


orrecting a Program 


Once the MODULE file has been created, you 
can begin testing. To execute the MANIP 
MODULE file, issue the MANIP command nane, 
plus the file identifiers for the input and 
output files. The input file  (MANIP 
ASSEMBLE A1) is to be copied and the 
resulting file is to be called MANIP1 
ASSEMBLE A1. The first test should take 
the branch on the FSREAD error. The 
following error message appears on the 
terminal: 


manip manip assemble a1 manip1 assemble a1 
ERROR CODE 7 IN READING FILE. 
R (00001) ; 


You should then use the Editor to 
correct the program so that this branch is 
no longer taken. 


edit manip assemble 

EDIT: 

find eof 

EOF EQU * 

next 

LA 15,7 TEST CODE FOR READ ERROR 
delete 

file 

R; 
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After the corrected version of the 
program is filed, assemble and execute the 
program again. 


assemble manip 
*3* ki 


ASSEMBLER (F) DONE 


NO STATEMENTS FLAGGED IN THIS ASSEMBLY 
R; 


load manip 
R; 


genmod manip 
R; 


Now that the testing statement has been 
deleted, and a new MODULE file created, 
further testing of the program can begin. 
First, attempt to copy a file that does not 
exist. The file is not found. 


manip file1 assemble a1 file2 assemble al 
FILE NOT FOUND 
R (00001) ; 


Then, attempt to copy a file to itself. 
Your program is not equipped to do this; an 
error occurs. 


manip manip assemble a1 manip assemble a1 
ERROR CODE 9 IN WRITING FILE. 
R (00001) ; 


Finally, create a new file (MANIP1) from 
your MANIP file. 


manip manip assemble al manip1 assemble al 
R; 
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ERASING UNWANTED FILES 


Once testing is complete, display the 
beginning of MANIP1 to make sure that it 
was copied correctly, then delete the 
MANIP1 file: 


type manip1 assemble 1 5 


MANIP CSECT 
PRINT NOGEN 
SAVE (14,12) ,,* 
BALR 12,0 
USING *,12 ESTABLISH ADDRESSABILITY 


R; 


erase manip1 assemble 
R; 

The LISTFILE command can then be issued 
to make sure the file was erased: 


listfile * assemble 
MANIP ASSEMBLE A1 
R; 


PRINTING, PUNCHING, AND READING FILES 


Printing 


When you want to print your proqram 
listing, you should first check the output 
status of your virtual printer by entering: 


query 00e 
PRT OOE CLS A COPY 01 
R; 
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A 


Since output class A is acceptable for 
program listings, print the LISTING file: 


print manip listing 
R; 


You can also print the LISTING file by 
specifying the PRINT option when you issue 
the ASSEMBLE command. Once the LISTING 
file is printed, it can be erased. Also, 
you may want to erase the TEXT file from 
which the MODULE file was generated: 


erase manip listing 
R; 


erase manip text 
R; 


Punching 


If other users want to use your MANIP 
program, send it to them by changing the 
destination of your virtual punch, then 
punch the MANIP TEXT file. Use the CMS 
COPYFILE or MOVEFILE commands to transfer 
the MANIP MODULE file to another user. For 
example, suppose the user PAYROLL wanted to 
use the MANIP program. You could send 
PAYROLL a copy of the TEXT file by 
entering: 


spool 00d to payroll 
R; 


punch manip text 
PUN FILE 029 TO PAYROLL 
R; 
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Reading 


When the user PAYROLL logs on the VM/SP 
system, the following message types during 
the logon procedure: 


FILES: 001 RDR, NO PRT, NO PUN 


The PAYROLL user can decide whether or 
not he wants the file before he reads it by 
invoking the command: 


query reader all 
FILE CLS RECDS ORIGIN DATE TIME NAME TYPE 
029 A 00051 PUBS 11/30/72 13:29:03 MANIP TEXT 


To read in this file, the PAYROLL user must 
IPL CMS and issue the command: 


read * 
:READ MANIP TEXT Al PUBS mm/dd/yy 13:29:03 
R; 


If the PAYROLL user does not want the 
file, he can purge it from his reader, as 
follows: 


purge reader (or purge reader 029) 
0001 FILE PURGED 


CMS can be used for many cther purposes. 
Those functions illustrated in the previous 
discussion are intended to help the new 
VM/SP user become acquainted with the 
system and its capabilities. Once you are 
familiar with these commands and functions, 
you have a sound base upon which to build a 
more thorough understanding of the VM/SP 
system. 
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Figure 5 lists the filetypes used by CMS 
and CMS/DOS commands. 


In addition to these CMS filetypes, 
there are special filetypes reserved for 
use by the language processors, which are 
IBM program products. For details, consult 
the appropriate program product 
documentation. 
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If a condition arises during execution of a 
command that results in the display of a 
Warning, Error, Severe Error, or Terminal 
Error message, the command passes a nonzero 
return code to register 15. 


If no Warning, Error, Severe Error, or 
Terminal Error messages are generated 
during execution of the command, the return 
code passed to register 15 is zero. 


Commands that invoke Program Products 
pass the return code set by the program in 
register 15 to the user. This code may 
have the same number as a CMS code 
described above; however, it will have been 
redefined by the Program Product Or 
compiler in operation. 


CMS RETURN CODES 


Figure 6 shows the return codes passed by 
CMS commands. 


AS, ə A II OS 
| RC | Meaning : 
-00011No CP command with this name vasil 
| found. (The CP error code of +1 isi 
{converted by CMS to | 20001 Tori 
{commands entered from the  virtual| 
| console.) i 


-0002|(An attempt vas made to execute af 
{CMS command while in CMS subset] 
{mode, which would have caused thel 
{module to be loaded in the user] 
larea (LOADMOD error code 32). | 

AAA A — ————————) 
Figure 6. Return Codes Produced by CMS 
(Part 1 of 3) 
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A ua E ee 
| RC | Meaning | 
[———— n P  ———ə ——  ——sƏs II 


1-00031No CMS command with this name wasl 


| 
l 
| 
| 
| 
| 
l 
l 
| 
| 
l 
l 
| 
| 
| 
| 
l 
i 
{ 
| 
l 
l 
l 
| 
| 
| 
l 
| 
l 
| 
| 
i 
| 
| 
i 
| 
| 
| 
t 


1⁄2 


20 


24 


28 


| found. | 
| | 


-00041The LOADMOD failed (for example, | 


[there was an error on the module). | 


-00051A LOADMOD was attempted with the] 


[wrong environment (for example, thel 
[module was generated by the GENMOD| 
{command with the OS option and| 
(LOADMOD was attempted with  DOS-ON| 
{specified). | 
Í | 
|The user did not specify all the] 
| conditions necessary to execute the| 
{command as intended. Execution of| 
[the command continues; however, the| 
{result may or may not be as the] 
[user intended. | 
| | 
|-Device errors occurred for which al 
[Warning message is issued, or | 
| I 
|-Errors have been introduced into] 
Ithe output file. | 
l | 
|Errors were found in the input] 
| file. i 
l | 
(An invalid character is in thel 
|fileid. Valid characters are: 0-9, 
AZ: $, 9, $, a-z. | 
| | 
{The user did not specify the| 
{command line correctly. | 
{ | 
{An error occurred while trying tol 
laccess, or manipulate, a user's] 
| files; for example, file nct found. | 


— ————————————————————— 


Figure 6. Return Codes Produced by CMS 
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RC | Meaning | 
h”—————--——- ———--ı 
32 |-The user's file is not in the| 
I expected format, or i 
|-The user's file does not contain| 
| the expected information. | 
| | 
36 |An error for which the user is| 
{responsible occurred on one of the| 
[user's devices. For example, al 
disk is in Tead-only status, and] 
[needs to be in write status so that| 
la file can be written on it. | 


256 {All unexpected errors for which thel 
[system is responsible; that is,I 
{Terminal Error messages. | 

ədə RIA AE AAA 

Figure 6. Return Codes Produced by CMS 

(Part 3 of 3) 


i 

| 

| 

| 

| 

| 

| 

| 

l 

| 

| 

| 

| 40 |-A functional error for which the] 
1 | user is responsible occurred | 
| | during execution of the command, | 
| | or | 
| {-The user failed to supply all the] 
| | necessary conditions for executing| 
| | the command, or | 
| |-End-of-file, end-of-tape (where| 
| I applicable). | 
| | | 
| 88 {-A CMS system restriction prevented| 
| | execution of the command, or | 
| [-The function reguested is an| 
| | unsupported feature, or | 
| |-The device requested is ani 
| | unsupported device. | 
| | | 
I 100 f(Input/output device errors. | 
l | | 
| 104 JA functional error for which thel 
| [system is responsible occurred] 
{ |during execution of the command. | 
| l 

| 

{ 

| 
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CP DIRECT COMMAND RETURN CODES 


Figure 7 shows the return codes passed by 
the CP DIRECT command. 


re səyə x ee A AA ee ee 


| RC | Meaning | 
——Fk —————]H— Mr—S 
1 [Invalid filename, or file not | 

| found. 


l 

i 

| | | 
| 2 | Error loading the directory. | 
| | | 
| 3 {Invalid option from CMS. | 
| l l 
| 4 (Directory not swapped, user not] 
| Iprivilege class A, B, or C. | 
| | i 
| 5 [Directory not swapped, system (old) | 
| | directory locked. | 
| 

| 

| 

| 

| 

l 

| 

l 

t 


1 | 

6 | Directory not swapped, the | 
{directory in use by the system is] 

[not the updated directory. | 

| | 

1xx1| Error in the CMS RDBUF routine. : 

| l 
2xx!|Error in the CMS TYPLIN routine. | 
a. A —————— n 
| 1xx is the CMS routine return code. | 
L.uuu uu u ————————————————————————————— | 


Figure 7. Return Codes Produced by the CP 
DIRECT Command 
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CMS DDR COMMAND RETURN CODES 


Figure 8 shows the return codes passed by 
the CMS DDR command. 


ey q AA ee RR oe yy URS ep ee üş 


| RC | Meaning | 
For E o. 
1 [Invalid filename, or file not 
| found. 


| | 
| | 
| | | 
i 2 |Error in executing the program. | 
| | | 
| 3 | Flagged DASD (Direct Access Storage| 
| | Device) track. | 
| | | 
| 4 {Permanent tape or DASD I/O error. | 
| | | 
| 1xx1| Error in the PRINTIO routine. | 
| | | 
| 2xx1| Error in the CONREAD routine. | 
| | | 
| 3xxt| Error in the RDBUF routine. | 
| | | 
| 4xx1{ Error in the TYPLIN routine. | 
$ 0 _-—--<Aá=>==> É— ss —a 
| 1xx is the CMS routine return code. | 
RL. xi — assasi 
Figure 8. Return Codes Produced by the 
CMS DDR Command 
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SYSTEM 
RETURN CODES 


PRODUCT EDITOR (XEDIT) COMMAND 


Figure 9 shows the return codes passed by 
the XEDIT command. 


| 
| 
l 
| 
| 
| 
l 
l 
l 
| 
i 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
l 
l 
| 
t 


RC 


NO E ae ae me əə əy əyə e 


| Meaning | 


nn {Command's RC specified as operand | 


-1 


| l 
{LOAD command has already been| 
lissued l 
| l 
| Normal | 


| i 
| TOP or EOF reached during execution] 


“.. line not found | 
TS is not a display terminal 
peer rer storage 

ee operand 

Tem rejected in the profile| 
| because of LOAD error | 
Eesen when building the update one 
e area contains subcommand that| 
lis not yet executed | 


12 IDisk is read-only | 


— ——————————————Á 


Figure 9. Return Codes Produced by the 
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System Product Editor  (XEDIT) 
Command (Part 1 of 2) 
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ee A A ə TEMPE EE ee ene 


| RC | Meaning | 
Fo ə ——— 
13 Disk is full | 

| | 

20 | Invalid character in filename orl 

| filetype d 

| | 

24 {Invalid filemode | 

| i 

36 | Disk has not been accessed as yet | 

| | 


88 (File is too large; cannot fit into] 
[storage | 
| 
100 (Error occurred while reading thel 
{file into storage | 
L... u a PE rU —————————————— s 8 
Figure 9. Return Codes Produced by the 
System Product Editor (XEDIT) 
Command (Part 2 of 2) 


IPCS COMMANDS RETURN CODES 


Figure 10 shows the return codes passed by 
the IPCS commands. 


po =<. E MENTI ES TN CES UIS S E ms Y 
I RC | Meaning | 
———— F-J TVI 
l 4 ¡An incorrectly entered parameter. | 
i | | 
| 8 [System failure; a read/write error] 
| lor an invalid internal parameter. | 
A Lİ 
Figure 10. Return Codes Produced by the 
IPCS Commands 
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EXAMPLE OF A RETURN CODE FROM A CP COMMAND 


Commands or functions of ccmmands passed 
to CP pass the return code sent back by CP 
to register 15. For example, suppose the 
user is in CMS mode and invokes the CP 
command LINK: 


ipl cms 
CMS VERSION n.n mm/dd/yy 


cp link to * vaddr1 as vaddr2 r 


The user has entered the CP command LINK 
to userid *. That means the user's own 
directory is searched for device vaddr1. 
Vaddr2 is the virtual address to be 
asSigned to the device for this virtual 
machine. Read-only access is requested. 
No password is required because the user 
has linked to one of his own disks. 


The result may be either 


R * which indicates successful 
execution. 


R(nnnnn); which indicates an error. 
If, aS previously described, 
the contents of nnnnnis a 
CMS return code, then the 
error occurred in CMS. Jf 
nnnnn contains a CP message 
number, the error occurred in 
CP. 


The return code may be used by a system 
programmer in the DEBUG subcommand and 
also in EXEC procedures. See the VM/SP CMS 
Command and Macro Reference for a 


description of the &£RETCODE Special 
variable. 
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The following list contains CP, CMS, IPCS, 
and RSCS commands and the VM/SP service 
aids; a brief description  precedes a 
Syntactic representation of each ccmmand. 


NOTATIONAL CONVENTIONS 


The following symbols should be coded as 
they appear in the command format. 


asterisk * 
comma e 
hyphen = 
equal sign 
parentheses 
period 
colon 


) 


... I 


The following symbols are used to 
define the command format and should not 
be coded as part of the command. 


braces { } indicate choices, one of 
which must ke selected. 


brackets [ ] indicate optional choices, 
one of which may be 
selected. 

underscore _ indicates a default 
option. If the 
underscored option is 
selected, it need not be 
specified. 
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vertical bar | separates the operand 
alternatives within the 
brackets and braces. 


ellipsis ... indicates that the 
preceding item may be 
repeated more than once. 


The commands and subcommands are shown 
in uppercase and lowercase; the uppercase 
represents the minimum truncation of the 
command or keyword operand that the system 


accepts. An all-lowercase operand 
indicates a user- or system-supplied 
variable value. Variable abbreviations 


used are shown in Figure 11. 


r Ss ans AA ə wu — ha 


¡Short Form] Meaning | 
AA AA AAA M 
laws {Alphameric information | 
{addr {Storage address | 
I cc ICylinder number | 
| col [Column | 
| cuu {Virtual device address | 
{cyl {Cylinder | 
| dasd [Direct access storage device | 
| fileid {fin ft [fm] | 
| fm | filemode { 
| fn | filename | 
{ft {filetype | 
| hexloc {hexadecimal storage location | 
[mode {Mode letter or mode letter and| 
| | mode number | 
(nn IDecimal information | 
|psw {Program status word 1 
| rad dr |Real storage address i 
[rec [record l 
Ivaddr IVirtual storaqe address | 


1.) 
Figure 11. Syntax Abbreviations Used 


For a detailed and thorouqh explanation 
of command formats and notational 
conventions, see the VM/SP CMS Command and 
Macro Reference. 
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CP PRIVILEGE CLASSES 


VM/SP users are divided into seven classes 
(A through G) according to the functions 
they must perform. Each user class may 
use a specific subset of CP commands. In 
addition, there are commands (class Any) 
available to all users. 


Figure 12 summarizes the CP privilege 
classes and the functions performed by 
each class of user. Figure 12 also 
indicates the publications in which the 
commands for each class are detailed. 


r NE. Yn əy ə ani” 8 4000036 7 “.“$ 

| Class| User and Function | 

See 
Ai 


Primary System Operator: The class| 
A user controls the VM/SP systen. | 
Class A is assigned to the user at] 
[the VM/SP system console during] 
IIPL. The primary system operator] 
lis responsible for the availability| 
lof the VM/SP system and its| 
{communication lines and resources. | 
{In addition the class A userl 
{controls system accounting, | 
| broadcast messages, virtual machine] 
{performance options, and other| 
{command operands that affect  the| 
loverall performance of VM/SP. The] 
[system operator controls operation] 
lof the real machine using the| 
{system control panel and console] 
| device. | 


|!Described in VM/SP Operator's Guide. i 

x 

Figure 12. CP Privilege Class Descriptions 
(Part 1 of 3) 
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— | 
r NE Ng a Yer q şm r AA seçə a tım OO KAA 
[Class] User and Function | | 
wegen SSSR A az uğcxex-bvpkuntoyyaxıboubbasiasszs 
(Note: The class A system operator] 
{who is automatically logged on| 
| during CP initialization is| 
{designated as the primary systen| 
loperator. 1 
| | 
Bt i System Resource Operator: The| 


{class B user controls allocation| 
land deallocation of all the real 


jresources of the VM/SP systen, | 
lexcept those controlled by the] 
| primary system operator and | 


|spooling operator. | 
| l 
C 1 [System Programmer: The class CI] 
juser updates certain functions Of 
{the VM/SP system. The system | 
{programmer can modify real storage| 
lin the real machine. | 
l | 
Di {Spooling Operator: The class DI 
{user controls spool data files and| 
{specific functions of the system's| 
junit record equipment. i 


Et | System Analyst: The class E user| 
{displays the contents of real| 
[storage, performs the functions] 


[required to generate saved systens| 
land discontiguous saved segments, | 
land controls the collection  and| 
{recording of performance | 
[measurement data. This class of| 
Juser can display the contents of 
[specified real storage areas on thel 
{virtual operator's console or on al 
{spooled virtual printer, but cannot| 
{modify real storage. | 


e 1 
{1Described in VM/SP Operator's Guide. | 
LAA AAA ae eine ieee ws endl 


Figure 12. CP Privilege Class Descriptions 
(Part 2 of 3) 
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| Classl User and Function | 
P——— —6—/. 
(Pi (Service Representative:The class F| 
| (user obtains and examines, in| 


detail, certain data about input] 
{and output devices connected to the| 
| VM/SP system. The service| 
[representative can establish] 
lintensive recording mode for one| 
|I/O device at a time and can cause| 
| the recording of repressable| 
| machine check errors to bel 
J initiated or resumed. | 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| | | 
| Ge [General User: The class G user 
| {controls functions associated with| 
| | the execution of his virtual 
| | machine. A general user  cannot| 
| {display or modify real storage. | 
| | | 
lAny? (The Any classification is given tol 
| | certain CP commands that are| 
{ lavailable to any user. These are] 
| | primarily for the purpose of | 
| {gaining and relinquishing access tol 
| [the VM/SP system. l 
| | | 
IH IReserved for IBM use. | 
F—— n r d 
|!iDescribed in VM/SP Operator's Guide. l 
I2pescribed in VM/SP CP Command Referencel 
I for General Users. ; 
RÉ Casada 
Figure 12. CP Privilege Class Descriptions 

(Part 3 of 3) 


CP, CMS, RSCS, AND IPCS COMMANDS 


The following table details command 
formats and descriptions. Also included 
are macro formats and service aids. 
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SX20-4400-0 


International Business Machines Corporation 
Data Processing Division 
1133 Westchester Avenue, White Plains, N.Y. 10604 


IBM World Trade Americas/Far East Corporation 
Town of Mount Pleasant, Route 9, North Tarrytown, N.Y., U.S.A. 10591 


IBM World Trade Europe/Middle East/Africa Corporation 
360 Hamilton Avenue, White Plains, N.Y., U.S.A. 10601 
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